Cheat Database Converter : RAINE 0.32a -> MAME 37B16
Coded by JCK from The Ultimate Patchers
Version 1.0B - Release date : 19th of July 2001


1. Archive contents

  - RAINMAME.C   : Source file (C code)
  - RAINMAME.EXE : Binary file (DOS and Win users only)
  - RAINMAME.TXT : This file ;)


2. Licence

This program is a FREEWARE, with some restrictions :

You are NOT allowed to :
- Charge for providing this program.
- Modify this program or the distribution archive, in ANY way.
  This includes adding/removing files to this archive.
- Distribute it with RAINE, MAME or derived emulators.

You ARE allowed to :
- Include it on any web server.
- Include it with cheat databases, if you also provide the WHOLE distribution
  archive within the database archive.
- Use this program :-)

I am NOT responsible of ANY kind of damages caused directly or indirectly by
RAINMAME. Use this program AT YOUR OWN RISK.

Bug reports : stephh@europe.com (type RAINMAME as subject of your mail)


3. Purpose

This program will convert cheats from a selected RAINE 0.32a cheat database
into cheats that can be used by MAME 37B16 .

DO NOT try to convert older RAINE cheat databases !


4. Usage

Typing 'RAINMAME' at the DOS prompt will give you a short help.

There are 3 arguments that you must fill :

  - <CheatFileIn> is the name of a valid RAINE cheat database.

  - <CheatFileOut> is the name of a MAME cheat database. Converted cheats
    will be added at the end of the file (if the file doesn't exist, it will
    be created).

  - <GameName> is the name of the game for which you want to convert the
    cheats. No tests are made to check if the game is currently emulated by
    MAME ! Note that you must type the short name of the game (8 chars max)

For example, if you type :
  rainmame \raine\cheatsup.cfg \mame\cheat_nf.cdb rastan
the cheats for 'rastan' from the file \raine\cheatsup.cfg under a
[rastan:cheats] section will be added to the file \mame\cheat_nf.cdb

The RAINE cheat database should not be modified, but I suggest you make a
copy of it before running this program.

This program can't guess MAME name according to RAINE's one ! It will never
do ! Remember that you can use this program even if you don't have RAINE
and/or MAME !

5. History

  1.0    First public release. Features :
           - cheats are converted to types 000, 001, 020, 021, 040, 041
             and 998 in MAME.
           - creates linked cheats in MAME if 16/24/32 bits cheats.
           - "extra description" field supported


6. Missing features/Improvements for a future version

  - none for the moment

7. Credits

  - MAME team  : if MAME didn't exist, such a program wouldn't be useful ;)
  - RAINE team : if RAINE didn't exist, such a program wouldn't be useful ;)
  - Mac Lak    : debug, comments and suggestions.
  - Pugsy      : host of our cheat databases and other miscellaneous tools
                   (cheat.retrogames.com)
